Inside Macintosh: /

QuickDraw 3D RAVE / QuickDraw 3D RAVE Reference

QuickDraw 3D RAVE Routines / Public Draw Context Methods

TQASetPtr

A drawing engine must define a method to set a pointer value for a draw context state variable.

typedef void (*TQASetPtr) (
                           TQADrawContext *drawContext, 
                           TQATagPtr tag, 
                           const void *newValue);

drawContext

A draw context.

tag

A state variable tag.

newValue

The new value of the specified state variable.

DESCRIPTION

Your TQASetPtr function should set the value of the draw context state variable specified by the drawContext and tag parameters to the pointer value specified by the newValue parameter.

Your drawing engine must accept all possible values for the tag parameter. If you encounter a value in the tag parameter that you cannot recognize, you should do nothing. Similarly, you should do nothing if the tag parameter specifies a state variable for optional features your drawing engine does not support.

SPECIAL CONSIDERATIONS

If your TQASetPtr function needs to change one or more of the function pointers in the specified draw context, it must call the QARegisterDrawMethod function to do so. It should not directly change the fields of a draw context.